home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / prog / asm_0_m.arj / FLASHDOS.DOC < prev    next >
Text File  |  1989-07-29  |  26KB  |  567 lines
  1. :gdoc sec='IBM INTERNAL USE ONLY'
  2. :frontm
  3. :titlep
  4. :title.FlashDOS Version 2.1
  5. :title.DOS Gateway
  6. :title.User's Guide
  7. :title.
  8. :title.(For IBM AT,PCC,PS2)
  9. .*etitle.
  10. :date.Jul 26,1989
  11. :author.Pedro E. Colla
  12. :author.VM(MARVM1/COLLA)
  13. :address
  14. :aline.Application Development & Maintenance
  15. :aline.Martinez Plant
  16. :aline.IBM Argentina
  17. :eaddress
  18. :etitlep
  19. .*
  20. :toc
  21. :body.
  22.  
  23. .*--- NEWS
  24.  
  25. .*--- Introduction
  26.  
  27. :h1.Introduction
  28. :p.:hp2.FlashDOS:ehp2. is a Resident program that lets the user
  29. to access the DOS environment from inside other applications.
  30. :p.The functional principle is to start a secondary DOS Command Processor
  31. from a TSR program.
  32. :p.Once under the secondary command processor, any DOS command or program
  33. could be runned as like as from the regular DOS prompt subjected to the
  34. memory available.
  35. :p.In this way a simplified form of serial multitasking is possible.
  36. :p.An option is provided to attach any non-TSR program to the :hp2.FlashDOS
  37. :ehp2. execution, provided that sufficient memory is allocated at
  38. loading time it can be invoked as a regular TSR.
  39. :p.:hp2.FlashDOS:ehp2. is NOT a multitasking environment nor an aplication
  40. switcher.
  41.  
  42. .sp 2
  43. :p.Some of the features are:
  44. :ul.
  45. :li.PopUp using a Hot-Key (Alt-BackSpace).
  46. :li.Both in-memory and swap to disk options available.
  47. :li.Memory reserved can be shrinked down to a minimun of 16K under user
  48. request when this resource is needed to another task (Memory swap only).
  49. :li.Memory allocation can be changed after initial installation.
  50. :li.This Program is carefully designed to avoid conflict with another
  51. TSR's on machine and other packages.
  52. :eul.
  53.  
  54. .*--- Hardware and Software requirements.
  55.  
  56. :h1.Hardware and Software requirements.
  57. .sp 2
  58. :p.:hp2.FlashDOS:ehp2. uses 17K for its own code and a minimun of 40K to
  59. let a secondary processor to start and execute internal commands (such as
  60. DIR or COPY), so virtually any true IBM PC/PS should qualify to use it.
  61. :p.At the start the program will take care of any environmental or
  62. PC installation factor that could impact it.
  63. :p.See appendix for detected hardware/software incompatibilities.
  64. :p.To run a specific program instead of regular DOS Command Processor an
  65. adequate amount of memory must be allocated.
  66. :p.DOS 3.0 or greater is adequate to run this program.
  67.  
  68. :h1.Using the program.
  69.  
  70. :p.The following sections deals with several aspects related to the program
  71. like it scope, use and technical details.
  72. :p.I expect that this information would be sufficient to any user but any
  73. additional information can be surveyed from a brief walkthru around the
  74. code.
  75.  
  76.  
  77. .*--- Invocation
  78.  
  79. :h2.Invocation
  80. :p.:hp2.FlashDOS:ehp2. can be invoked by just enter :hp2.FLASHDOS:ehp2. at
  81. DOS prompt.
  82. :p.After :hp2.FlashDOS:ehp2. is invoked the program will run some housekeeping
  83. code like:
  84. :ul.
  85. :li.DOS Version Checking.
  86. :li.Ensure that not another copy of the program is already loaded.
  87. :li.Validate and process specified command switchs.
  88. :li.Allocate required memory workspace (Internal memory swap only).
  89. :li.Trap required interruption handlers.
  90. :li.Become a TSR extension of DOS.
  91. :eul.
  92. :p.The user could tell the program to work with an internal or external
  93. workspace.
  94. :p.On the internal workspace option a block of memory (user specified,
  95. default 64K) are reserved in top of its own code needs netting up around 80K.
  96. :p.If external (disk) swap option is specified, no memory is reserved and
  97. the workspace is made swapping the current application in memory (or part
  98. of it) to disk, provided that enough space is available on any of the
  99. defined drives (including RAM-Disk such as VDISK).
  100. :p.Also, the program lets the user to specify configuration options by means
  101. of 'switches' passed as a parameters.
  102. :p.Using switches the format is:
  103. .fo off
  104.               +------------------+
  105.               |                  |
  106.               |FLASHDOS /{switch}|
  107.               |                  |
  108.               +------------------+
  109. .fo on
  110. :p.Where {switch} may  be the following:
  111. :ol.
  112. :li.:hp2.A:ehp2. Switch.
  113. :p.This switch tell :hp2.FlashDOS:ehp2. to search for a copy of itself in
  114. memory and if it is inactivated try to activate them.
  115. :p.The workspace is claimed back and if it cann't a message error is given
  116. and the program remains on inactive state.
  117. :p.If there are not a copy of the program installed in memory when this
  118. switch is specified an error message is displayed and no action is taken.
  119. :p.Example:: FLASHDOS /A
  120.  
  121. :li.:hp2.I:ehp2. Switch.
  122. :p.This switch tell :hp2.FlashDOS:ehp2. to search for a copy of itself in
  123. memory and if it is founded active at this time inactivate them.
  124. :p.When become inactive the workspace memory is released and the space
  125. occupied is shrinked down to the minimun amount needed to keep the code
  126. (around 7K).
  127. :p.When in inactive mode :hp2.FlashDOS:ehp2. will not popup upon request
  128. and exception given by the installed code acts as if there are not any
  129. copy in memory at all.
  130. :p.Example:: FLASHDOS /I
  131.  
  132. :li.:hp2.E:ehp2. Switch.
  133. :p.This switch tell :hp2.FlashDOS:ehp2. to select :hp2.External:ehp2 swap
  134. in which the current application or part of it is dumped to the first
  135. drive in which the required space is available.
  136. :p.If this switch is not specified the workspace is reserved :hp2.in memory
  137. :ehp2.
  138. :p.The current application :hp2.must:ehp2. have a memory allocation greater
  139. or equal than the amount of memory defined to :hp2.FlashDOS:ehp2. as a
  140. workspace size by the user (or default).
  141. :p.Example: FLASHDOS /E
  142.  
  143. :li.:hp2.H:ehp2. Switch.
  144. :p.This switch tell :hp2.FlashDOS:ehp2. to select the :hp2.Huge Swap Mode
  145. :ehp2. in which the current application is swapped entirely to disk at
  146. the popup momemnt regardless the workspace indicated by the user.
  147. :p.The workspace is allways set as the memory used by the current
  148. application minus 256 bytes (16 paragraphs).
  149. :p.The external swap mode is also forced when this option is indicated.
  150. :p.Example: FLASHDOS /H
  151.  
  152. :li.:hp2.U:ehp2. Switch.
  153. :p.This switch tell :hp2.FlashDOS:ehp2. to search a copy of itself in
  154. memory and either active or inactive try to desinstall and release the memory
  155. used for it.
  156. :p.There are some situations where the Uninstall request cann't progress
  157. without crash the entire system, in such a situation a message is given and
  158. an Inactivation process is started, more of this later.
  159. :p.Example:: FLASHDOS /U
  160.  
  161. :li.:hp2.9999:ehp2. Switch.
  162. :p.Really not a switch is a way to tell FlashDOS the amount of memory that
  163. must be used as a workspace.
  164. :p.The memory is indicated in terms of :hp2.paragraphs:ehp2. used as a
  165. workspace, a paragraph is the DOS allocation unit and is composed by a fixed
  166. quantity of 16 bytes.
  167. :p.Using this option if another copy is detected already installed a change
  168. in the size of the workspace is attempted, if there are not suficient memory
  169. to satisfy the request the program is placed on :hp2.Inactive:ehp2. mode
  170. (as if the :hp2./I:ehp2. were invoked).
  171. :p.If not specified :hp2.FlashDOS:ehp2. will assume 4096 paragraphs (64K)
  172. as a workspace size.
  173. :p.The need and optimun size of this workspace is discussed later in this
  174. document.
  175. :p.If this switch is used and another copy of the program is present in
  176. memory the status is checked and if it is :hp2.Inactive:ehp2. an attempt
  177. is made to change the size of the workspace area provided that adequate
  178. quantity of memory can be released by DOS.
  179. :p.If several switches are used specify the size one at last, otherwise
  180. the switches after it will be ignored.
  181. :p.The number of paragraphs must be informed with 5 digits format, the
  182. leftmost positions must be padded with zeroes as needed.
  183. :p.Example: FLASHDOS /04096
  184.  
  185. :li.:hp2.?:ehp2. Switch.
  186. :p.This switch tells :hp2.FlashDOS:ehp2. to display a short online help.
  187. :p.When using this facility the program is not installed after termination
  188. no matter if the program is already installed or not.
  189. :P.Example: FLASHDOS /?
  190.  
  191. :li.:hp2.C {d:}{path}{filename}:ehp2. Switch.
  192. :p.This switch can be used at loading time to indicate to start an
  193. specific task when :hp2.FlashDOS:ehp2. is Poped Up.
  194. :p.This switch, if specified, must be used :hp2.only:ehp2. at loading time;
  195. if a copy of :hp2.FlashDOS:ehp2. is detected in memory a warning message
  196. is given and the indication of the switch are discarded.
  197. :p.The task may be a program (.COM or .EXE types) or a .BAT file.
  198. :p.The task invoked in this way :hp2.cann't:ehp2. be any kind of resident
  199. DOS extension.
  200. :p.No check is done at loading time to ensure that the file supporting the
  201. task really exist, an attempt to load the program under popup request is
  202. made using the drive, path and filename information and if it is not sucefull
  203. a error message is given.
  204. :p.This parameter can be specified together with the memory size option to
  205. specify both initial values in one shot.
  206. :p.In such a case the /C switch :hp2.MUST BE:ehp2. specified first,
  207. otherwise it will be ignored.
  208. :p.Example (1): FLASHDOS /C DEBUG  (Will load DEBUG program at popup).
  209. :p.Example (2): FLASHDOS /C BASICA /08000 (Will load BASICA with 128K space).
  210.  
  211. :eol.
  212.  
  213.  
  214. .*--- History
  215.  
  216. :h1.Functional Description.
  217.  
  218. :p.After the short description given above about how to install :hp2.FlashDOS
  219. :ehp2. and its main options some functional description is in place.
  220.  
  221.  
  222. :h2.Usage Notes.
  223.  
  224. :p.The way of do things with a PC could be quite different between my own case
  225. and anyone else, the conclusions given below could not be partially aplicable
  226. nor not aplicable at all.
  227. :p.The vast majority of times that I need to interrupt my work with the
  228. PC is to do something trivial, mostly using a DOS command like copy a
  229. file from/to anyone else or gives to the already started DOS's PRINT
  230. something to print.
  231. :p.Also I use to run in this situation one of the zillion utilities that
  232. quickly do something and terminate, like shown the directory tree, found
  233. a file or set something to anything different than what currently is.
  234. :p.I really do not need (nor want) to run several 'power' task at the same
  235. time.
  236. :p.The rational behind is that I cann't handle several complex things at the
  237. same time with a reasonable degree of proficiency.
  238. :p.The definitively right mix is a somewhat difficult task and
  239. a esporadic trivial thing.
  240. :p.In order to load a secondary :hp2.DOS Command Processor:ehp2. a piece
  241. of memory must be free (45K minimun).
  242. :p.:hp2.FlashDOS:ehp2. have two ways to clear the memory space required;
  243. using his own reserved workspace (Internal WorkSpace Option) and swapping
  244. to disk part or all the current application (External WorkSpace Option).
  245. :p.Both methods will be explained briefly.
  246.  
  247. :h3.Internal WorkSpace Option.
  248.  
  249. :p.This option (assumed as a default) forces :hp2.FlashDOS:ehp2. to reserve
  250. at loading time a block of memory given by the user (default 64K).
  251. :p.The first thing that the program do when is invoked with the hot key is
  252. to release this memory to general DOS use, this ensure that there are
  253. sufficient memory space to start a secondary DOS command processor and
  254. depending upon the size of the workspace to start another task using it.
  255. :p.After termination the space is claimed again and puts under the
  256. property of :hp2.FlashDOS:ehp2. again, this action will ensure the next
  257. popup request to be sucefully performed.
  258. :p.As more large is the space owned by :hp2.FlashDOS:ehp2. a greater
  259. program could be started within it, but when :hp2.FlashDOS:ehp2. is not
  260. active the space is reserved and cann't be used for anything else.
  261. :p.So a tradeoff is in place depending of the kind of task that is expected
  262. to be runned while in popup mode.
  263. :p.I found myself confortable to work with the default workspace (64K) that
  264. was sufficient to cover my usual needs, this is sufficient to let DOS to
  265. load the secondary COMMAND.COM and run any of the most common DOS commands
  266. or short utilities that I normally use in such a case.
  267. :p.For this purpose the internal swap option has the advantage of a very
  268. fast switching time and the memory penalization is not too strong.
  269. :p.Obviously, the space reserved as a workspace is no longer useful to
  270. run other things.
  271. :p.If a resident program is installed when :hp2.FlashDOS:ehp2. is in charge
  272. a lot of problems should be expected, so this action must be avoided.
  273. :p.The initial size of the workspace could be changed once installed to
  274. any other greater or lower than the original one, provided that there are
  275. enough memory to do that; to change the workspace size the program status
  276. must be previously set to inactive.
  277. :p.This technique should be used in a spartan way because some memory
  278. fragmentation could be expected on each memory size change, at the limit
  279. you can convert your PC's addressing space in a lot of small and unuseable
  280. chunks of memory and probably the only way to solve this situation is to
  281. re-boot the entire system.
  282.  
  283. :h3.External WorkSpace Option.
  284.  
  285. :p.If there are a need to run programs that requires memory spaces bigger
  286. than 20-30K probably the selection of the External WorkSpace Option should
  287. be used.
  288. :p.This option is selected at loading time by means of the :hp2./E:ehp2.
  289. switch.
  290. :p.Under this working mode :hp2.FlashDOS:ehp2. will only reserve memory
  291. space for itself and the video swap buffer, netting up around 14K.
  292. :p.When the hot-key is detected and if the conditions are OK to pop-up, a
  293. fraction of the current application is swapped to disk and the space is
  294. released for general DOS use.
  295. :p.In order to swap all the available drives (F: thru A:) are scanned for
  296. sufficient space, the first drive with enough space is selected and the
  297. memory portion is swapped under the name :hp2.FLASHDOS.SWP:ehp2., this file
  298. is created as a :hp2.hidden file:ehp2. so you cann't see this with the normal
  299. DOS DIR command, but the decrease in the free disk space will reflect the
  300. space used.
  301. :p.When the :hp2.FlashDOS:ehp2. session is ended (typing EXIT at the
  302. DOS prompt), the memory of the current (interrupted) application is
  303. restored back to his original position from the previously created swap file.
  304. :p.Upon completion, the swap file is erased.
  305. :p.Using this option a bigger workspace size becomes practical, but an
  306. excesive allocation for workspace means a bigger switching time.
  307. :p.A practical tradeoff is to define a 128K workspace size under this
  308. option (/E /08000), with it a 1-5 sec. switching time would be expected.
  309. :p.An extension of this mode is the :hp2.Huge Swap Mode:ehp2. in which the
  310. workspace size is not defined at load time and the :hp2.entire:ehp2. space
  311. used by the current application is used instead.
  312. :p.This mode (selected by the :hp2./H:ehp2. switch) could be used to
  313. run massive applications under :hp2.FlashDOS:ehp2. , but you would be aware
  314. about the switching time that becomes noticeable.
  315. :p.Also, this option should be avoided on machines that lacks a hard disk
  316. because the swap file will tipically use 500-600K; impossible to handle with
  317. a no-hard-disk PC-1 and barely handled with a PCC using an ad-hoc empty
  318. 3.50" diskette.
  319. :p.A big difference between :hp2.Internal:ehp2. and :hp2.External:ehp2.
  320. workspace options is that under :hp2.External:ehp2. you can run any kind
  321. of terminate-and-stay-resident kind of program, once finished those programs
  322. are wiped out the memory.
  323. :p.But, as a balance, when :hp2.FlashDOS:ehp2. is in charge any TSR program
  324. loaded after its initial load will be inactive.
  325. :p.The amount of memory allocated as a workspace to acomplish a lot of
  326. useful task is small, but if one of these packages that need a huge amount
  327. of memory is runned the best thing to do is to put the program on inactive
  328. status.
  329.  
  330. :h2.De-Installing the program.
  331.  
  332. :p.If the ability to uninstall :hp2.FlashDOS:ehp2. is wanted, this program
  333. must be last in the TSR chain, otherwise is far more safe to keep the
  334. program in place and inactivate them.
  335. :p.To avoid conflicts due to un-installation, :hp2.FlashDOS:ehp2. checks
  336. if :hp2.All:ehp2. the interrupts vectors trapped by it still pointing
  337. to his segment; if not, the un-installation request is discarded.
  338.  
  339. :h2.Programming Details.
  340.  
  341. :p.The technical aspects involved in writing a program like :hp2.FlashDOS
  342. :ehp2. will be probably somewhat dark to the non-technical oriented user.
  343. :p.On the other side, for the experienced and technical oriented user the
  344. concepts may be a deceptive repetition of a well knowed list of techniques.
  345. :p.Trying to write down all the aspects involved in the coding of a TSR
  346. program under DOS probably would be far beyond the scope of this manual
  347. anyway.
  348. :p.The source code of this program is provided with the package in order
  349. to let the interested user to walk thru it.
  350.  
  351. :h1.Final Notes.
  352.  
  353. :p.All the :hp2.FlashDOS:ehp2. test was done using DOS 4.0, but the program
  354. uses well consolidated functions since DOS 3.1 so I'm not expect any problem
  355. if :hp2.FlashDOS:ehp2. is loading under a previous DOS release, provided that
  356. it must be greater or equal 3.1.
  357. :p.Other PCTOOLS and commercial packages works in a similar way than
  358. :hp2.FlashDOS:ehp2. does, but none of it was used partially or fully to develop
  359. this program.
  360. :p.The program was done in my own time and equipment, some 'user test' was
  361. done on my office PS-50 under DOS 4.0 and in my PCC running under DOS 4.0.
  362. :p.During the test conflictive situations with another programs was solved
  363. or are documented here, but I only tested the program in my usual environments
  364. (home & office).
  365. :p.The program is :hp2.IBM Internal Use:ehp2. and :hp2.IBM's employees
  366. Internal Use:ehp2.
  367. :p.Please if you have any comments, compatibility problem or enhancement
  368. suggestion don't hesitate to drop me a note.
  369. .sp 2
  370. .ce Pedro E. Colla
  371. .ce Martinez Plant
  372. .ce IBM Argentina
  373. .ce COLLA @ MARVM1
  374. .ce 61322772 @ TOROHON1
  375.  
  376.  
  377.  
  378.  
  379. :appendix.
  380. :h1.Messages.
  381. :p.Errors are reflected by means of error messages, each message is
  382. displayed on certain event.
  383. :p.Also, some messages are informative ones, so given to inform the user
  384. that something happen.
  385. :p.Following is the list of all the messages defined on :hp2.FlashDOS:ehp2.
  386. and a short explanation about it meaning.
  387. :ol.
  388. :li.Invalid Function Code
  389. :p.This is an error returned by the DOS Loader when an invocation other than
  390. :hp2.Load & Execute:ehp2. or :hp2.Load Overlay:ehp2. is done, never should
  391. happen exception given by a corrupted load module.
  392. :li.Access Denied
  393. :p.An attempt to load a file locked to another purpose was done, try later.
  394. :li.Memory Blocks Destroyed
  395. :p.The DOS memory control blocks are corrupted, re-boot the computer.
  396. :li.Insufficient memory
  397. :p.No sufficient memory is available to load the desired program.
  398. :li.Invalid Memory Block Address
  399. :p.An attempt to access a DOS control block corresponding to an inexistent
  400. memory block was done, never should happen exception given by a corrupted
  401. load module.
  402. :li.Invalid Media
  403. :p.The indicated drive contains a media that is not recognized by DOS.
  404. :li.Invalid Format
  405. :p.The indicated drive contains a media that is unformatted.
  406. :li.Protection Exception
  407. :p.:hp2.FlashDOS:ehp2. attempted to access a memory zone not belonging to it,
  408. reboot the computer.
  409. :li.Something wrong occurs
  410. :p.An unexpected and unspecified error was founded, reboot the computer.
  411. :li.Now Inactive
  412. :p.Informative message, tells the user that a copy of the program was founded
  413. on memory and now is changed to inactive status.
  414. :li.Ended
  415. :p.Informative message displayed whenever the popup end.
  416. :li.Secondary COMMAND cann't start
  417. :p.A COMMAND.COM file is not founded in the path indicated by the COMSPEC
  418. variable at load time.
  419. :li.Cann't claim memory
  420. :p.The amount of memory released at popup time cann't be claimed back, usually
  421. because some of the programs loaded lets a resident portion, put on inactive
  422. mode and change the memory size to popup again.
  423. :li.Not Loaded
  424. :p.Informative message displayed whenever the program didn't terminate on
  425. a 'stay resident mode'.
  426. :li.Loaded sucefully
  427. :p.Informative message displayed whenever the program becames a resident DOS
  428. extension.
  429. :li.Already Loaded
  430. :p.Informative message that tell the user that another copy of the program
  431. was founded somewhere in the memory, use DOS's MEM utilty with /DEBUG option
  432. to check it (DOS 4.0) or PCTOOLS's SYSMAP package.
  433. :li.Already Active
  434. :p.Informative message, an activation request was done and the copy of the
  435. program present in memory was already active, not action is taken.
  436. :li.Already Inactive
  437. :p.Same as above but for an inactive request when the program is already
  438. inactive.
  439. :li.Now Active
  440. :p.Informative message that tell the user that his Activation request end
  441. sucefully.
  442. :li.Uninstalled sucefully
  443. :p.Informative message that indicates that an un-installation request was
  444. done sucefully.
  445. :li.Memory area allocated at 9999:0000h
  446. :p.Informative message given at first load telling about the starting
  447. address of the allocated workspace.
  448. :li.Memory size 9999h Paragraphs.
  449. :p.Informative message given at first load telling about the size of the
  450. defined workspace area.
  451. :li.User File Defined
  452. :p.This informative message tell the user that a file to execute at popup
  453. time (see /C switch) was detected and sucefully processed.
  454. :li.Incorrect DOS Level
  455. :p.An attempt to load the program under a version of DOS previous to 3.0
  456. was done, the loading end inmediately.
  457. :li.Unable to restore Int 09h.
  458. :p.An un-installation request was done but the Int 09h point now to somewhere
  459. different of the :hp2.FlashDOS:Ehp2. code segment indicating that another
  460. TSR program grabbed away the interrupt.
  461. :p.The un-installation request is aborted and a regular Inactivation request
  462. is done.
  463. :li.Unable to restore Int 13h.
  464. :p.Same as above but to BIOS Int 13h.
  465. :li.Unable to restore Int 21h.
  466. :p.Same as above but to DOS Int 21h.
  467. :li.Not previously loaded.
  468. :p.Informative message, an attempt to change the current status was done
  469. and no copy of the program can be founded on memory.
  470. :li.Incorrect parameter, type FlashDOS /? for help"
  471. :p.An invalid switch was specified.
  472. :li.Memory mgmt error.
  473. :p.The DOS memory block has been destroyed, reboot the computer ASAP.
  474. :li.PSP do not belong to Usr Program.
  475. :p.Some problems to identify which program is the main one has been detected.
  476. :li.Disk error, Can not swap out.
  477. :p.Disk error during the swap process.
  478. :li.Not enough space to swap.
  479. :p.None of the available drives have enough space to swap the memory required
  480. by the workspace.
  481. :li.User memory not enough.
  482. :p.The current program memory allocation must be equal or bigger than the
  483. required workspace memory space, otherwise it cann't be swapped.
  484. :li.Can not open swap file.
  485. :p.Some problem arises when the swap file open was attempted.
  486. :li.Can not swap to file.
  487. :p.Some problem arises when the swap file write was attempted.
  488. :li.Can not shrink Usr memory.
  489. :p.The user memory cann't be shrinked down by DOS.
  490. :li.User program swapped OK.
  491. :p.Informative message, swap process end sucefully.
  492. :li.Can not retrieve memory.
  493. :p.The original user memory size cann't be restored to his original size.
  494. :li.Can not close swap file.
  495. :p.Some problem arise when the swap file close was attempted.
  496. :li.Can not erase swap file.
  497. :p.Some problem arise when the swap file erase was attempted.
  498. :li.Huge Mode Selected.
  499. :p.Informative message, the huge mode was selected.
  500. :eol.
  501. :h1.Detected Incompabilities.
  502. :p.The following incompabilities and depart of peaceful co-existence has
  503. been detected:
  504. :ol.
  505. :li.:hp2.MYTE:ehp2. (Migreatable Yorktown Terminal Emulator).
  506. :p.For some reason under study MYTE must be loaded :hp2.before:ehp2.
  507. FlashDOS, otherwise the first switch to terminal mode the system becames
  508. crashed.
  509. :p.No problem was detected if :hp2.FlashDOS:ehp2. is loaded :hp2.after:ehp2.
  510. MYTE, even on a un-installation request.
  511. :li.:hp2.PC-1/PC-XT:ehp2.
  512. :p.Several test done on PC-1s and PC-XT under DOS 3.0 thru DOS 3.3 exposed
  513. a erratic behavior, frecuently ended with a machine crash.
  514. :p.The sympthoms ranges from an sporadic hang-up to a guaranteed crash at
  515. the first pop up invocation (even, sometimes, at load time).
  516. :p.This kind of behavior are not showed at all on the PCC or the PS-2s in
  517. which the program was tested.
  518. :p.The reasons for that remains unexplained and are under examination.
  519. :li.:hp2.DOS 4.0 SHELL:ehp2.
  520. :p.Sometimes after a popup under the DOS 4.0 Shell some extraneous effects
  521. appears.
  522. :p.Those effects are no consistent nor repetitive and doesn't appear when
  523. the internal workspace is used; till the discovery of the reason, if you
  524. are a DOS 4.0 Shell beloving user please avoid to use :hp2.FlashDOS:ehp2.
  525. with the :hp2./E:ehp2. switch or at least avoid to popup from them.
  526. :eol.
  527. :p.I check incompatibilites on my working (and home) software environment, so
  528. if you detect another one please drop me a note.
  529. :h1.Release History.
  530. :ol.
  531. :li.:hp2.Version 0.1:ehp2.
  532. :p.Basic release, alfa test version.
  533. :li.:hp2.Version 0.7:ehp2.
  534. :p.Beta test version, features added:
  535. :ul.
  536. :li.DOS Version check.
  537. :li.Get COMMAND.COM path from COMSPEC environmental variable.
  538. :li.Switch to specify memory workspace other than 64K added.
  539. :li.Inactive/Active option.
  540. :li.Remove option.
  541. :li.Help facility added.
  542. :eul.
  543. :li.:hp2.Version 1.0:ehp2.
  544. :p.PCTOOLS release version, features added:
  545. :ul.
  546. :li.Change installed memory size option added.
  547. :li.Attach a program to popup mode added.
  548. :eul.
  549. :li.:hp2.Version 2.0:ehp2.
  550. :p.Features added:
  551. :ul.
  552. :li.Wait for a key to be pressed when an error occurs.
  553. :li.Option to create the workspace swapping the current application to disk.
  554. :li.Swap back and forth the interrupt vector table at popup time.
  555. :li.Create a program own stack in order to avoid conflicts with other programs.
  556. :li.The screen is not cleared when a program is attached to the :hp2.FlashDOS
  557. :ehp2. popup (/C option).
  558. :eol.
  559. :li.:hp2.Version 2.1:ehp2.
  560. :p.Features added:
  561. :ul.
  562. :li.Huge swap mode added, under it the current application is swapped entirely.
  563. :li.Resident code memory usage optimization.
  564. :li.Pop-Up error messages optimized.
  565. :eul.
  566. :egdoc.
  567.